<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
    "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="generator" content="AsciiDoc 8.2.1" />
<style type="text/css">
/* Debug borders */
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
/*
  border: 1px solid red;
*/
}

body {
  margin: 1em 5% 1em 5%;
}

a {
  color: blue;
  text-decoration: underline;
}
a:visited {
  color: fuchsia;
}

em {
  font-style: italic;
}

strong {
  font-weight: bold;
}

tt {
  color: navy;
}

h1, h2, h3, h4, h5, h6 {
  color: #527bbd;
  font-family: sans-serif;
  margin-top: 1.2em;
  margin-bottom: 0.5em;
  line-height: 1.3;
}

h1 {
  border-bottom: 2px solid silver;
}
h2 {
  border-bottom: 2px solid silver;
  padding-top: 0.5em;
}

div.sectionbody {
  font-family: serif;
  margin-left: 0;
}

hr {
  border: 1px solid silver;
}

p {
  margin-top: 0.5em;
  margin-bottom: 0.5em;
}

pre {
  padding: 0;
  margin: 0;
}

span#author {
  color: #527bbd;
  font-family: sans-serif;
  font-weight: bold;
  font-size: 1.1em;
}
span#email {
}
span#revision {
  font-family: sans-serif;
}

div#footer {
  font-family: sans-serif;
  font-size: small;
  border-top: 2px solid silver;
  padding-top: 0.5em;
  margin-top: 4.0em;
}
div#footer-text {
  float: left;
  padding-bottom: 0.5em;
}
div#footer-badges {
  float: right;
  padding-bottom: 0.5em;
}

div#preamble,
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
div.admonitionblock {
  margin-right: 10%;
  margin-top: 1.5em;
  margin-bottom: 1.5em;
}
div.admonitionblock {
  margin-top: 2.5em;
  margin-bottom: 2.5em;
}

div.content { /* Block element content. */
  padding: 0;
}

/* Block element titles. */
div.title, caption.title {
  font-family: sans-serif;
  font-weight: bold;
  text-align: left;
  margin-top: 1.0em;
  margin-bottom: 0.5em;
}
div.title + * {
  margin-top: 0;
}

td div.title:first-child {
  margin-top: 0.0em;
}
div.content div.title:first-child {
  margin-top: 0.0em;
}
div.content + div.title {
  margin-top: 0.0em;
}

div.sidebarblock > div.content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}

div.listingblock {
  margin-right: 0%;
}
div.listingblock > div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock > div.content {
  padding-left: 2.0em;
}

div.attribution {
  text-align: right;
}
div.verseblock + div.attribution {
  text-align: left;
}

div.admonitionblock .icon {
  vertical-align: top;
  font-size: 1.1em;
  font-weight: bold;
  text-decoration: underline;
  color: #527bbd;
  padding-right: 0.5em;
}
div.admonitionblock td.content {
  padding-left: 0.5em;
  border-left: 2px solid silver;
}

div.exampleblock > div.content {
  border-left: 2px solid silver;
  padding: 0.5em;
}

div.verseblock div.content {
  white-space: pre;
}

div.imageblock div.content { padding-left: 0; }
div.imageblock img { border: 1px solid silver; }
span.image img { border-style: none; }

dl {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
dt {
  margin-top: 0.5em;
  margin-bottom: 0;
  font-style: italic;
}
dd > *:first-child {
  margin-top: 0;
}

ul, ol {
    list-style-position: outside;
}
ol.olist2 {
  list-style-type: lower-alpha;
}

div.tableblock > table {
  border: 3px solid #527bbd;
}
thead {
  font-family: sans-serif;
  font-weight: bold;
}
tfoot {
  font-weight: bold;
}

div.hlist {
  margin-top: 0.8em;
  margin-bottom: 0.8em;
}
div.hlist td {
  padding-bottom: 5px;
}
td.hlist1 {
  vertical-align: top;
  font-style: italic;
  padding-right: 0.8em;
}
td.hlist2 {
  vertical-align: top;
}

@media print {
  div#footer-badges { display: none; }
}

div#toctitle {
  color: #527bbd;
  font-family: sans-serif;
  font-size: 1.1em;
  font-weight: bold;
  margin-top: 1.0em;
  margin-bottom: 0.1em;
}

div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
  margin-top: 0;
  margin-bottom: 0;
}
div.toclevel2 {
  margin-left: 2em;
  font-size: 0.9em;
}
div.toclevel3 {
  margin-left: 4em;
  font-size: 0.9em;
}
div.toclevel4 {
  margin-left: 6em;
  font-size: 0.9em;
}
include1::./stylesheets/xhtml11-manpage.css[]
/* Workarounds for IE6's broken and incomplete CSS2. */

div.sidebar-content {
  background: #ffffee;
  border: 1px solid silver;
  padding: 0.5em;
}
div.sidebar-title, div.image-title {
  font-family: sans-serif;
  font-weight: bold;
  margin-top: 0.0em;
  margin-bottom: 0.5em;
}

div.listingblock div.content {
  border: 1px solid silver;
  background: #f4f4f4;
  padding: 0.5em;
}

div.quoteblock-content {
  padding-left: 2.0em;
}

div.exampleblock-content {
  border-left: 2px solid silver;
  padding-left: 0.5em;
}

/* IE6 sets dynamically generated links as visited. */
div#toc a:visited { color: blue; }
</style>
<title>REMOTE-MCH(1)</title>
</head>
<body>
<div id="header">
<h1>
REMOTE-MCH(1) Manual Page
</h1>
<h2>NAME</h2>
<div class="sectionbody">
<p>remote-mch -
   Re-Mote mote control host
</p>
</div>
</div>
<h2>SYNOPSIS</h2>
<div class="sectionbody">
<p>remote-mch [options]</p>
</div>
<h2>DESCRIPTION</h2>
<div class="sectionbody">
<p>The mote control host manages mote devices and provides remote access to them
through a mote control server. On startup the mote host connects to the server
and listens for incoming requests. Requests allows motes to be programmed,
started, stopped, and reset. All console output from motes are forwarded to
the server.</p>
<p>The mote control host may be run both in the foreground and as a daemon.</p>
</div>
<h2>OPTIONS</h2>
<div class="sectionbody">
<p>The following options can be specified on the command line.</p>
<dl>
<dt>
--config-file=&lt;path&gt;
</dt>
<dd>
<p>
        Path to the configuration file. Default is "/etc/remote-mch.cfg".
</p>
</dd>
<dt>
--daemonize=[1|0]
</dt>
<dd>
<p>
        Run as a daemon. Default is to not daemonize.
</p>
</dd>
<dt>
--help
</dt>
<dd>
<p>
        Print usage help and exit.
</p>
</dd>
</dl>
</div>
<h2>CONFIGURATION OPTIONS</h2>
<div class="sectionbody">
<p>Use the following options to configure the mote host.</p>
<dl>
<dt>
devicePath &lt;string&gt;
</dt>
<dd>
<p>
        Path to the mote device hierarchy.
        When not specified "/dev/remote/" is used.
</p>
</dd>
<dt>
usbPlugEventPipe &lt;string&gt;
</dt>
<dd>
<p>
        Path to the fifo notifying the mote host of mote hotplug events.
        By default the daemon listens on "/var/run/motehost.events".
</p>
</dd>
<dt>
serverAddress &lt;string&gt;
</dt>
<dd>
<p>
        DNS or IP address of the mote server.
        Default is localhost.
</p>
</dd>
<dt>
serverPort &lt;number&gt;
</dt>
<dd>
<p>
        Port number to use for connecting to the mote server.
        The default port is 10001.
</p>
</dd>
<dt>
serverConnectionRetryInterval &lt;number&gt;
</dt>
<dd>
<p>
        Number of seconds to wait between server connection retries.
        Default is 30 seconds.
</p>
</dd>
</dl>
</div>
<h2>FILES</h2>
<div class="sectionbody">
<p>The mote host uses the following configurable files.</p>
<dl>
<dt>
/etc/remote-mch.cfg
</dt>
<dd>
<p>
        Default configuration file read on startup.
</p>
</dd>
<dt>
/var/run/motehost.events
</dt>
<dd>
<p>
        Default file for listening on mote events.
</p>
</dd>
</dl>
<p>For each mote managed by the mote host, the following device specific files
are used. The device path is configurable (default: "/dev/remote"). MOTEMAC
represents the MAC address of a mote.</p>
<dl>
<dt>
/dev/remote/MOTEMAC/programmer
</dt>
<dd>
<p>
        Symbolic link to the mote programmer. The programmer is called
        with the TTY as the first argument and path to the image file
        as the second argument.
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/controller
</dt>
<dd>
<p>
        Symbolic link to the mote control program.
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/tty/control
</dt>
<dd>
<p>
        Symbolic link to the mote control TTY.
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/tty/data
</dt>
<dd>
<p>
        Symbolic link to the mote data TTY.
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/image
</dt>
<dd>
<p>
        Temporary image file used when programming.
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/path
</dt>
<dd>
<p>
        File containing the mote device path in the form of a path specifying
        the bus ID. E.g. "/devices/pci0000:00/0000:00:10.0/usb2/2-1".
</p>
</dd>
<dt>
/dev/remote/MOTEMAC/platform
</dt>
<dd>
<p>
        File containing the name of the mote platform. E.g. "dig528-2".
</p>
</dd>
</dl>
</div>
<h2>ENVIRONMENT VARIABLES</h2>
<div class="sectionbody">
<p>The mote host does not use any externally defined environment variables. When
invoking the programmer and controller commands the mote host uses the
following environment variables.</p>
<dl>
<dt>
platform
</dt>
<dd>
<p>
        The mote platform, e.g. "MicaZ".
</p>
</dd>
<dt>
macaddress
</dt>
<dd>
<p>
        The mote MAC address.
</p>
</dd>
<dt>
tosaddress
</dt>
<dd>
<p>
        The mote TOS address.
</p>
</dd>
</dl>
</div>
<h2>COPYRIGHT</h2>
<div class="sectionbody">
<div class="verseblock">
<div class="content">Copyright (c) 2005-2006 Esben Zeuthen &lt;zept@diku.dk&gt;
Copyright (c) 2006-2008 Jonas Fonseca &lt;fonseca@diku.dk&gt;
Copyright (c) 2007-2008 Rosta Spinarr &lt;rostislav.spinar@cit.ie&gt;</div></div>
<p>This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.</p>
</div>
<h2>SEE ALSO</h2>
<div class="sectionbody">
<p><strong><a href="remote-mcs.1.html">remote-mcs(1)</a></strong>,
<strong><a href="remote-device-add.7.html">remote-device-add(7)</a></strong>,
<strong><a href="remote-device-remove.7.html">remote-device-remove(7)</a></strong>,
<strong><a href="remote-device-name.7.html">remote-device-name(7)</a></strong></p>
<p>This program is part of <a href="http://remote-testbed.googlecode.com/">the Re-Mote Testbed Framework</a>.</p>
</div>
<div id="footer">
<div id="footer-text">
Last updated 20-Mar-2008 16:12:16 CEST
</div>
</div>
</body>
</html>
